The screen-aligned pixel rectangle with lower left corner at (_x, _y) and
with a width of _w_i_d_t_h + 2 * _b_o_r_d_e_r and a height of _h_e_i_g_h_t + 2 * _b_o_r_d_e_r
defines the texture array at the mipmap level specified by _l_e_v_e_l.
_i_n_t_e_r_n_a_l_f_o_r_m_a_t specifies the internal format of the texture array.
The pixels in the rectangle are processed exactly as if ffffggggllllCCCCooooppppyyyyPPPPiiiixxxxeeeellllssss had
been called, but the process stops just before final conversion. At this
point all pixel component values are clamped to the range [0,1] and then
converted to the texture's internal format for storage in the texel
array.
Pixel ordering is such that lower x and y screen coordinates correspond
to lower s and t texture coordinates.
If any of the pixels within the specified rectangle of the current
GGGGLLLL____RRRREEEEAAAADDDD____BBBBUUUUFFFFFFFFEEEERRRR are outside the window associated with the current
rendering context, then the values obtained for those pixels are
undefined.
NNNNOOOOTTTTEEEESSSS
ffffggggllllCCCCooooppppyyyyTTTTeeeexxxxIIIImmmmaaaaggggeeee2222DDDD is available only if the GL version is 1.1 or greater.
Texturing has no effect in color index mode.
1, 2, 3, and 4 are not accepted values for _i_n_t_e_r_n_a_l_f_o_r_m_a_t.
An image with height or width of 0 indicates a NULL texture.
When the GGGGLLLL____AAAARRRRBBBB____iiiimmmmaaaaggggiiiinnnngggg extension is supported, the RGBA components read
from the framebuffer may be processed by the imaging pipeline. See
ffffggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee1111DDDD for specific details.
EEEERRRRRRRROOOORRRRSSSS
GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____EEEENNNNUUUUMMMM is generated if _t_a_r_g_e_t is not GGGGLLLL____TTTTEEEEXXXXTTTTUUUURRRREEEE____2222DDDD.
GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____VVVVAAAALLLLUUUUEEEE is generated if _l_e_v_e_l is less than 0.
GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____VVVVAAAALLLLUUUUEEEE may be generated if _l_e_v_e_l is greater than log max, where
2
max is the returned value of GGGGLLLL____MMMMAAAAXXXX____TTTTEEEEXXXXTTTTUUUURRRREEEE____SSSSIIIIZZZZEEEE.
GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____VVVVAAAALLLLUUUUEEEE is generated if _w_i_d_t_h or _h_e_i_g_h_t is less than 0, greater
than 2 + GGGGLLLL____MMMMAAAAXXXX____TTTTEEEEXXXXTTTTUUUURRRREEEE____SSSSIIIIZZZZEEEE, or if _w_i_d_t_h or _h_e_i_g_h_t cannot be represented
k
as 2 + 2 * _b_o_r_d_e_r for some integer k.
GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____VVVVAAAALLLLUUUUEEEE is generated if _b_o_r_d_e_r is not 0 or 1.
GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____VVVVAAAALLLLUUUUEEEE is generated if _i_n_t_e_r_n_a_l_f_o_r_m_a_t is not one of the
allowable values.
GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____OOOOPPPPEEEERRRRAAAATTTTIIIIOOOONNNN is generated if ffffggggllllCCCCooooppppyyyyTTTTeeeexxxxIIIImmmmaaaaggggeeee2222DDDD is executed
between the execution of ffffggggllllBBBBeeeeggggiiiinnnn and the corresponding execution of
2. ffffggggllllCCCCooooppppyyyyTTTTeeeexxxxIIIImmmmaaaaggggeeee2222DDDD and ffffggggllllCCCCooooppppyyyyTTTTeeeexxxxIIIImmmmaaaaggggeeee2222DDDDEEEEXXXXTTTT cannot be used if a
GLX video source is the current read drawable (see
ffffggggllllXXXXMMMMaaaakkkkeeeeCCCCuuuurrrrrrrreeeennnnttttRRRReeeeaaaaddddSSSSGGGGIIII). Executing it will generate a